home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 015a / qshel102.zip / QSHELL.DOC < prev    next >
Text File  |  1991-09-28  |  19KB  |  373 lines
  1.  
  2.                        ┌───────────────────────────┐
  3.                        │        QUICK SHELL        │
  4.                        │                           │
  5.                        │        Version 1.1        │
  6.                        │                           │
  7.                        │          (C) 1991         │
  8.                        │     Freestyle Software    │
  9.                        │    ALL Rights  Reserved   │
  10.                        └───────────────────────────┘
  11.  
  12.  
  13.  
  14.  
  15.                                USING QUICK SHELL
  16.  
  17.      ────────────────────────────────────────────────────────────────-
  18.  
  19.  
  20.  
  21.  
  22.                                PROGRAM OVERVIEW
  23.  
  24.            Load Quick Shell from the command line by typing QShell, or
  25.      include  the  command in your autoexec.bat file if you want it to
  26.      load automatically when you boot your system.
  27.  
  28.            If you have a mouse, be sure and load the driver before you
  29.      run  Quick Shell.  Quick Shell recognizes both keyboard commands,
  30.      and  responds  to your mouse if it is installed and the driver is
  31.      present.  All keyboard commands appear at the bottom of the Quick
  32.      Shell screen,  and  scrollable,  indexed help is available either
  33.      by pressing the F1 key, or by selecting HELP from the  horizontal
  34.      menu at the top of the Quick Shell screen.
  35.  
  36.           Commands are simple.  They mainly consist of the escape key,
  37.      the arrow keys, the F1 key, the F10 key, and the Enter key. Using
  38.      a mouse, a small solid rectangular symbol  at the upper left of a
  39.      menu or window  has  the same function as the escape key.   Click
  40.      on it once with your mouse to execute it.   A small solid diamond
  41.      shape symbol in the upper right of a  menu or window has the same
  42.      function as the enter key.  Click on it once to execute it.  From
  43.      most windows  or menus,  double  clicking on the upper horizontal
  44.      menu returns to it and activates the upper menu.  The F10 key has
  45.      the same function.   A few windows,  such as an error message, or
  46.      the help screen,  will NOT allow you to return  to the upper menu
  47.      without  first pressing the escape key or clicking on the rectan-
  48.      gular symbol in the upper left of the window.   Almost every pos-
  49.      sible  option currently available is listed at the bottom of each
  50.      Quick Shell screen.  The help system clarifies their usage.
  51.  
  52.           The Quick Shell Main Menu consists of six options.   Use the
  53.      arrow keys to select an option,  or click once on the option with
  54.      your mouse, and double click the option to accept it.  Select the
  55.      Drives option to log to another drive.   The default is the drive
  56.      current at Quick Shell startup.  Select the Directories option to
  57.      view the directory tree and select a directory function.  The de-
  58.      fault is the directory current at Quick Shell startup. Select the
  59.      Files option to view the files in the current directory,  and ac-
  60.      cess  the file options.   Select  Specs to change the file search
  61.      and list specification parameter.   The default is standard para-
  62.      meter [*.*].  Of course, Help summons context sensitive help, and
  63.      pressing  the  enter  key  or  clicking the diamond symbol in the
  64.      upper right  hand corner of the help screen calls up the help in-
  65.      dex.  Select  Quit  from the main menu to exit the program.  When
  66.      the Main Menu is present (and only then),  the Directories window
  67.      and  the Files window are each accessible by double clicking your
  68.      mouse cursor in the respective window.  So to select another dir-
  69.      ectory, simply double click the directory window.  From either of
  70.      those  two  main  windows,  when the title of the opposite window
  71.      appears (Directories or Files), the opposite window is accessible
  72.      by double clicking your mouse cursor in it.   For example, if you
  73.      have  selected Directories,  and subsequently selected a specific
  74.      directory,  double  clicking in the Files window once returns you
  75.      to  the main menu,  and double clicking again in the Files window
  76.      highlights and selects the files option.   Or from the Files win-
  77.      dow, double click TWICE on the directories window to activate the
  78.      directories option.  So with a mouse present, selection of direc-
  79.      tories or files is greatly speeded up.
  80.  
  81.           Each time a Main Menu option is selected and accepted, a new
  82.      horizontal menu appears at the top of the screen corresponding to
  83.      the selected option.  Activate the new menu with the F10 key,  or
  84.      by double clicking on the menu bar with your mouse cursor. To re-
  85.      turn  to the Main Menu,  select the option MAIN when present.  To
  86.      return to the current option, select the FIRST option of any sub-
  87.      menu, which corresponds to the name of the option.   For example,
  88.      after  selecting  Drives from the main menu,  press F10 or double
  89.      click  the Drives sub-menu at the top of the screen to access the
  90.      sub-menu.   Select Main  to return to the main menu, or Drives to
  91.      return  to  drive selection.   With  a mouse, you may also double
  92.      click on the drives window to re-activate it.   This is also true
  93.      of the Directories menu, and the Files Menu. From either of those
  94.      options, activate the corresponding menu as described above.  Re-
  95.      turn to the Main Menu by selecting Main, or the current option by
  96.      selecting  the  FIRST  sub- menu option or double clicking on the
  97.      current option window.  So if you are selecting a directory,  you
  98.      may access the directories menu with F10 or by double clicking on
  99.      it. You may then return to selecting directories by double click-
  100.      ing in the directories window,  or by selecting the first option,
  101.      which  is 'Directories',  and so on.   Return to the Main Menu by
  102.      selecting 'Main.'
  103.  
  104.            Drives sub-menu options consist of Drives (which returns to
  105.      drive selection),  Help, and Main.  The are largely self evident.
  106.      Directories sub-menu options consist of Directories, Add, Remove,
  107.      Help, and Main.   Select Add to add a new directory to a disk, or
  108.      Remove to remove and existing directory.  The Files sub-menu con-
  109.      sists of these options: Files, Run, View, Print, Copy, Attribute,
  110.      Erase, Help, and Main.  Run launches or executes the file that is
  111.      currently highlit in the files window.  View attempts to view the
  112.      file.   Print prints the file.  Copy copies the TAGGED files from
  113.      one  drive and/or directory to another.  Erase deletes the TAGGED
  114.      files.
  115.  
  116.  
  117.                                CHANGING DRIVES
  118.  
  119.          Change drives with the Drives option from the Main Menu.  All
  120.      physical drives  are  detected and listed.   Use the  arrow  keys
  121.      to select a drive from the list,  or click on a drive letter with
  122.      your  mouse  cursor.   You may also select a drive by clicking on
  123.      the  arrow  symbols  at the right of the drive window.  Press the
  124.      enter key to accept the highlit  drive letter,  or click  on  the
  125.      diamond symbol at the upper right of the drive window.  Press F10
  126.      to  access  the  drive menu,  or double click on the it with your
  127.      mouse  cursor.  The escape key,  or  double clicking on the solid
  128.      rectangular symbol at the  upper left of the drives window,  can-
  129.      cels the selection process and no drive change  is  made.  In the
  130.      same way,  accessing the Drives menu and selecting Main,  returns
  131.      without any change.
  132.  
  133.  
  134.  
  135.                          WORKING WITH DIRECTORIES
  136.  
  137.           Select Directories from the main menu to work with directo-
  138.      ries  on  the current drive.   Select a directory with the arrow
  139.      keys  or  by  clicking  on the directory with your mouse cursor.
  140.      Scroll the  directory list by clicking on the arrow symbols that
  141.      appear  at  the right of the directory window when it is active.
  142.      Use  the help function to clarify the usage of scroll arrow sym-
  143.      bols.   To add a directory, access the Directories Menu, and se-
  144.      lect Add.  Enter a legal directory name (up to eight characters,
  145.      with  an  optional three character extension separated by a per-
  146.      iod...just as a dos file name).  Remove a directory by selecting
  147.      the Remove option.   Quick Shell verifies  the removal, but ONLY
  148.      ONCE!   After selecting a directory by highlighting it,  make it
  149.      current  and view any files in it either with the Enter key,  or
  150.      by  clicking on the diamond symbol  in  the upper  right of  the
  151.      Directories window.   This  action  also returns you to the Main
  152.      Menu.   Double clicking on the Files window once also returns to
  153.      the  main menu,  and double clicking  on  it  again accesses the
  154.      Files  option  where  you can work with the files in the current
  155.      directory.
  156.  
  157.  
  158.  
  159.                              WORKING WITH FILES
  160.  
  161.           Access the files window either by selecting Files from the
  162.      Main Menu,  or as mention priveously, by double clicking on the
  163.      files window. Select a file with the arrow keys, or by clicking
  164.      on a file name with the mouse cursor.  Tag the selected file by
  165.      pressing the Enter key, or by clicking on the diamond symbol at
  166.      the upper right of the file window.   You can tag as many files
  167.      as you like.   Tagged files are then available to the file copy
  168.      and erase options from the Files sub-menu. Untag files by high-
  169.      lighting  a  tagged  file,  and again pressing the Enter key or
  170.      clicking on the diamond symbol. Access the sub-menu by pressing
  171.      F10 or by double clicking on the menu bar itself.
  172.  
  173.            From the Files sub-menu, select Run to launch, or execute
  174.      an executable file. Executable files are those with .EXE, .COM,
  175.      or .BAT extensions.  There must be enough memory left to launch
  176.      the  selected  file.   You do not need to tag a file to run it.
  177.  
  178.             Select View from the files menu to view a file.  You may
  179.      choose  to view the file as ascii characters, or in hexadecimal
  180.      format.   The view option has it's own sub-menu, consisting  of
  181.      View, Search, Color,  Help, and FileMenu.   Access the sub-menu
  182.      in  the same way as others.   Select View to return to viewing,
  183.      Search to search for text, Color to change viewing colors, Help
  184.      for  view  help,  and FileMenu to return to the Files sub-menu.
  185.      QShell  only loads files up to sixty four kilobytes into memory
  186.      for  viewing.   Longer files are truncated.  You do not need to
  187.      tag  a file to view it.  The currently highlit file is selected
  188.      by default.
  189.  
  190.             Select Print from the files menu to print the  currently
  191.      selected file.  You may print the file in ascii characters,  or
  192.      in hexadecimal characters.   Interrupt the print process at any
  193.      time with the escape key, or by clicking on the solid rectangu-
  194.      lar symbol at the upper left of the print process window.   The
  195.      print  process  window  appears  at the beginning of the actual
  196.      print process.  An expandable bar indicates the relative amount
  197.      that has been printed from within this window.  You do not need
  198.      to tag  a file to print it.  The currently highlit file is sel-
  199.      ected by default.
  200.  
  201.             Select Copy to copy tagged files to another drive and/or
  202.      directory.  Tag files as previously described.  After selecting
  203.      the file copy option,  you must select the drive to copy tagged
  204.      files  into.   You  must  also select the directory you want to
  205.      place the files in. You're guided throughout this process. Sim-
  206.      ply described,  select  a drive and press enter or click on the
  207.      diamond symbol; then select the target drive and press enter or
  208.      click on the diamond symbol.  Clicking on the solid rectangular
  209.      symbol,  or pressing escape anywhere along the way, cancels the
  210.      process.   You  may also create a new directory during the copy
  211.      process.   When  prompted  to select a target directory, access
  212.      the Directories sub-menu and select Add.   Add the new directo-
  213.      ry  and  re-access the directories window.   Scroll down to the
  214.      new directory and complete the copy process as described above.
  215.      The copy process verifies all files at the byte level,  byte by
  216.      byte.  Although slower, this is a highly reliable method.
  217.  
  218.            Select  Attribute  to change the attributes of a selected
  219.      file. The five possible attributes are Anyfile, Read Only, Sys-
  220.      tem, and Archive.  You do not need to tag  a file to change its
  221.      attribute.   The currently highlit file is selected by default.
  222.      However,  each  attribute  appears in the attribute window, and
  223.      ATTRIBUTES  must be tagged in order to place the attribute into
  224.      effect.   As each attribute is tagged or untagged, the combina-
  225.      tion in effect appears to the right of the file name.  Aborting
  226.      the  attribute process leaves the file unchanged;  pressing the
  227.      enter key  or clicking on the diamond symbol changes the attri-
  228.      bute.
  229.  
  230.            Select Erase to delete tagged files.  If only one file is
  231.      tagged,  you  are  cautioned and prompted for verification that
  232.      you do indeed want to delete the tagged file.   CAUTION!   This
  233.      verification only appears once!   If more than one file is tag-
  234.      ged,  you  are presented with the option to delete all at once,
  235.      or  verify  them one at a time during the deletion process.  If
  236.      you  select all at once,  ALL of the files will be deleted!  So
  237.      be  careful  with this option.  You may abort at any time up to
  238.      the  last  verification  with the escape key, or by clicking on
  239.      the rectangular escape symbol.
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.                              UPGRADED VERSIONS
  250.  
  251.      ────────────────────────────────────────────────────────────────-
  252.  
  253.           Version 1.2 fixes all known and reported bugs in V 1.0   and
  254.      V 1.1 on 9/28/91.  This included the failure of the directory de-
  255.      letion routine to account for one floppy drive (C: drive was seen
  256.      by the program as B:); screen fouling when clicking with  a mouse
  257.      cursor below the file list; and problems with the help index when
  258.      using the keyboard instead of a mouse to select help subject.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                              FOR ETHICAL USERS
  269.  
  270.      ────────────────────────────────────────────────────────────────-
  271.  
  272.             Try QShell.   Distribute it freely.   If you're amused  by
  273.      it, but find no use for it, don't worry about it.  If it's  cute,
  274.      but  beneath  your  dignity, give it away.  Still,  if  you  find
  275.      yourself  USING  it, if it works for you,   the shareware license
  276.      fee is $20.00.
  277.  
  278.              It's  the  nature and spirit of things that  really  make
  279.      them  valuable  to  us.   QShell has a very reasonable price, and
  280.      several nice features  you  may not find at any price.  Used pro-
  281.      perly, these features can save you personal time.
  282.  
  283.           If QShell saves time, it saves money.  At $20.00, the QShell
  284.      License is nominal.  If it  only saved a few accumulated hours in
  285.      the course of a season,  it would still be  significant. Your own
  286.      time is unquestionably  worth  more  than  a few dollars an hour,
  287.      isn't it?
  288.  
  289.            QShell is copyrighted.  If you use QShell,  Send your check
  290.      or money order to Freestyle Software, 24307 Magic  Mountain Park-
  291.      way, Suite 255, Valencia, CA, 91355.   The QShell license is only
  292.      $20.00.   So if you use it,  be dignified  enough to register it.
  293.      It's the right thing to do.  (Yeah, yeah...He's Naive!)
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.                                  DISCLOSURES
  302.  
  303.      ────────────────────────────────────────────────────────────────-
  304.  
  305.                 QShell contains  assembly units  licensed  from  Eagle
  306.      Performance Software.   QShell was written in Pascal and compiled
  307.      using  Turbo  Pascal  Version 5.5 for MS-Dos or IBM-Dos operating
  308.      systems version  2.x to 5.x.  Turbo Pascal is a trademark of Bor-
  309.      land International, MS-Dos is a trademark of  the  Microsoft cor-
  310.      poration,  and  naturally,  IBM  is  a trademark of International
  311.      Business  Machines.  The  Freestyle  Company belongs to me and my
  312.      wife.
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.                                   CAVEATS!
  321.  
  322.      ─────────────────────────────────────────────────────────────────
  323.  
  324.        This  program is provided on an as is basis.  The user  assumes
  325.      all risk as to the performance,  quality,  or reliability  of the
  326.      product.  No warranties,  implied or otherwise, are made, includ-
  327.      ing, but not limited to,  any  'implied' warranties  of merchant-
  328.      ability,  fitness,  or suitability  for any particular purpose or
  329.      design.  A user waives  ALL other claims,  and the Freestyle Com-
  330.      pany,  or any other purveyor  or dealer of this product,  becomes
  331.      free from responsibility of ALL liabilities  or damages,  includ-
  332.      ing, but not limited to, lost revenues or profits,  unsuitability
  333.      of performance for a user's particular needs,  damage to a user's
  334.      computer hardware or software, any other incidental or consequen-
  335.      tial damages arising out of the use  of or inability  to use this
  336.      program, even if the Freestyle Company has been advised of possi-
  337.      ble damages.
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.                            OTHER FREESTYLE PRODUCTS
  346.  
  347.      ────────────────────────────────────────────────────────────────-
  348.  
  349.              If you like QShell, you might also find use for FSRead, a
  350.      very  fast text file browser that allows loading files up to 425K
  351.      into memory.    Change drives from an automacally  built  menu of
  352.      drives,  or directories from a full graphic tree. Choose up to 36
  353.      color attribute combinations for file viewing.  Mark text blocks,
  354.      or enter text strings for searches, and set place markers for ex-
  355.      tremely quick searching.   Print out all, or just portions of any
  356.      text file.  FSRead was written as a shareware documentation  file
  357.      reader, and is entirely light bar menu driven, with pop-up inter-
  358.      active help.  Then there's FSLabel!  If you own a Hewlett Packard
  359.      printer,  FSLabel is one of the  few automatic disk labeling pro-
  360.      grams that reads the file names on a disk and prints a label on a
  361.      full sheet of lables.   Select the exact label position on screen
  362.      by moving the cursor on a visual page of labels.  FSLabel is easy
  363.      to use, and prints labels for either 3.5" or 5.25" diskettes. You
  364.      may  also  be  interested  in FSText,  a quick style analyzer for
  365.      readability,  personal  interest,  and negativity  of writing for
  366.      journalism, public relations, or advertising copy. You might also
  367.      enjoy  a  need for Snapshot,  a TSR screen image saver.  Snapshot
  368.      pops-up as you need it to save text based screen images to a disk-
  369.      file.  You may later view or print the images as you need them.
  370.  
  371.  
  372.                           END QShell DOCUMENTATION
  373.